抖音开放平台Logo
控制台

Android 接入
收藏
我的收藏

本文为抖音短视频 Android 终端 SDK 新手使用教程，只涉及 SDK 的使用方法，默认读者已经具有使用 Android Studio 开发 Android 程序的经验，以及相关的编程知识基础等。​

​前提条件​

    •​请确保 SDK 最低支持 Android API 15 - 4.0.x 版本。​
    •​向抖音短视频申请你的 ClientKey（下文简称 AppID）及相关权限：​
    a.​请到开发者应用登记页面进行申请，申请后将获得 AppID。具体步骤请参见创建移动应用和网站应用。​
    b.​通过 AppID 为应用申请相关的权限，如分享、授权等。​
    c.​审核通过后即可使用相关的功能。​

​接入流程​

SDK 接入目前需要引入两个依赖包，包括opensdk-china-external和opensdk-common，为了方便，两者使用同样的版本号。当前最新版本为 0.2.0.2。​
    1.​将 SDK 集成到开发环境。​
    2.​配置抖音的软件包可见性。​

​操作步骤​

    1.​将 SDK 集成到开发环境，需要添加如下配置。​
js
复制
//gradle文件中添加：
repositories {
maven { url 'https://artifact.bytedance.com/repository/AwemeOpenSDK' }
}
dependencies {
implementation 'com.bytedance.ies.ugc.aweme:opensdk-china-external:0.2.0.2'
implementation 'com.bytedance.ies.ugc.aweme:opensdk-common:0.2.0.2'
}
    2.​配置抖音的软件包可见性。​
Android 11 为了加强了隐私保护策略，引入了很多变更和限制，其中软件包可见性变更，将会导致第三方应用通过抖音开放平台的 SDK 无法正常拉起抖音，从而无法使用开放平台的全部功能，包括但不限于分享消息到抖音、通过抖音进行账号登录等功能。特别需要注意的是，Android11 的该变更只会影响到升级<strong>targetSdkVersion=30</strong>的应用，未升级的应用暂不受影响。​
js
复制
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.xxx.xxxx">
<queries>
<!--允许查询抖音和抖音极速版的软件包信息-->
<package android:name="com.ss.android.ugc.aweme" />
<package android:name="com.ss.android.ugc.aweme.lite" />
<package android:name="com.ss.android.ugc.live" />
</queries>
</manifest>
至此，SDK 开发环境配置完毕. 具体子功能接入请查阅相关功能接入文档。​
常见问题，请参见 Android 常见问题。​